Windcave
Windcave is a third party supplier which is integrated with ebs to process online payments. You must contact Windcave to agree a contract.
When you have negotiated a contract with Windcave, you are ready to start the configuration with ebs. At this point you should have received a URL from Windcave that is specific to your organisation.
The institution settings for Windcave are configured on the following screens (accessed from the Product Modules pane):
ePayments (Self-Service)
The institution settings on the ePayments (Self-Service) screen for Windcave are shown below.
The fields on the ePayments (Self-Service) screen that are relevant to Windcave are described in the following table. It is recommended that unused fields are left blank.
| This field | Holds this information... |
|---|---|
| ePayment provider |
The electronic payment provider being used for ebs: ontrack Learner Hub. Select Windcave from the drop-down list. |
| ePayment URL |
The URL provided by Windcave. Note: This field must include the URL of your payment provider. |
| Payment Account ID | The Windcave account ID. |
| Payment Account Key | The Windcave account key. |
| Only use default account code for payments | It is recommended this field is set to N for Windcave . |
| Payment Merchant Reference | The payment merchant reference for Windcave . |
| Default Payment Email Address | The email address to which transaction emails are sent (that is: your ebs: ontrack Learner Hub URL). |
| Generate single fee line, use default account code and VAT code only (SCP Only) | It is recommended this field is set to N for Windcave . |
| Payment Host IP Address | The payment host IP address for Windcave . |
| Payment Process Allowed IP Addresses - (Empty=Allow All) | The payment process allowed IP address for Windcave or leave blank to allow all. |
| Only use default VAT code for payments | It is recommended this field is set to N for Windcave . |
| Default VAT code | The default VAT code to use for Windcave . |
| ePayment failure message (Prospect) | The message displayed to learners in ebs: ontrack Learner Hub when payment fails in the institution's payment provider. |
ePayments (Staff)
The institution settings on the ePayments (Staff) screen for Windcave are shown below.
The fields on the ePayments (Staff) screen that are relevant to Windcave are described in the following table. It is recommended that unused fields are left blank.
| This field | Holds this information... |
|---|---|
| ePayment provider |
The electronic payment provider being used for ebs: central. Select Windcave from the drop-down list. |
| ePayment URL |
The URL provided by Windcave. Note: This field must include the URL of your payment provider. |
| Payment Account ID | The Windcave account ID. |
| Payment Account Key | The Windcave account key. |
| Only use default account code for payments | It is recommended this field is set to N for Windcave . |
| Payment Merchant Reference | The payment merchant reference for Windcave . |
| Default Payment Email Address | The email address to which transaction emails are sent. |
| Generate single fee line, use default account code and VAT code only (SCP Only) | It is recommended this field is set to N for Windcave . |
| Payment Host IP Address | The payment host IP address for Windcave . |
| Payment Process Allowed IP Addresses - (Empty=Allow All) | The payment process allowed IP address for Windcave or leave blank to allow all. |
| Only use default VAT code for payments | It is recommended this field is set to N for Windcave . |
| Default VAT code | The default VAT code to use for Windcave . |
| The Method of Transfer That ebs: central Uses For ePayments |
The method of transfer that ebs uses for ePayments. Note: To use the Display payment in popup window setting, contact ebs support as this requires a custom Windcaveimplementation. |
The data sent to Windcavewhen making a payment is described in the following table.
| Value | Source | Notes |
|---|---|---|
| PxPayUserId | Payment Account Id | As defined in institution settings |
| PxPayPayKey | Payment Account Key | As defined in institution settings |
| TxnId | The ePayment transaction ID | Generated from EPAYMENT_TRANSACTION_ID_SEQ DB sequence when creating the payment |
| AmountInput | The total amount being paid | - |
| CurrencyInput | The CurrencyCode institution setting ('CurrencyCode') | - |
| EmailAddress | Email Address from the payment details | Uses the Default Payment Email Address institution setting if user does not have one defined |
| MerchantReference | The Payment Merchant Reference institution setting | - |
| TxnType | 'Payment' | - |
| TxnData1 | The first 250 bytes of the payment details (pid) token | - |
| TxnData2 | The second 250 bytes of the payment details (pid) token | - |
| TxnData3 | The third 250 bytes of the payment details (pid) token | - |
| UrlFail | The URL used to report back the status of the failed payment | This is the server path appended with /epayments/PaymentResponse.aspx |
| UrlSucceed | The URL used to report back the status of the successful payment | This is the server path appended with /epayments/PaymentResponse.aspx |
Note: Refer to PCI Compliance for further information about how ebs interacts with Windcave.